home *** CD-ROM | disk | FTP | other *** search
/ Aminet 6 / Aminet 6 - June 1995.iso / Aminet / comm / bbs / crazy8s2.lha / 8s.doc < prev    next >
Encoding:
Text File  |  1994-11-23  |  8.9 KB  |  248 lines
  1.  
  2.  
  3. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  4.  
  5.              a                    i              s 
  6.         C r     z              E          h   t        !!!!!
  7.                    y                 g
  8.  
  9. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 
  10.  
  11.  
  12.         Original AmigaBASIC author unknown. (Many, many thanks).
  13.  
  14.                 Converted to a Metro Door by Peter Deane
  15.  
  16.                       Release 4 was (5 June 1991)
  17.  
  18.                    This 2.0 release 23 November 1994
  19.   
  20.                         (c) 1991 by Peter Deane
  21.  
  22.  
  23. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 
  24.  
  25.  
  26.  
  27. WARNING! * WARNING! * WARNING! * WARNING! * WARNING! * WARNING! * WARNING!
  28.         
  29.  You must have two .bmap files on your SYS: disk before you run this door.
  30.  
  31.  They are the 'graphics.bmap' and 'dos.bmap' files which must be in the
  32.            libs: directory of your SYS: disk (ie boot drive)
  33.  
  34.       These .bmap files are supplied in the distribution archive.
  35.  
  36. WARNING! * WARNING! * WARNING! * WARNING! * WARNING! * WARNING! * WARNING!
  37.  
  38.  
  39. [This is a version of my old Crazy 8s Door, now recompiled with a couple of
  40.  very small changes to get it to run under the new OzMetro BBS program.
  41.  These docs are pretty well 1991 vintage, but any notes added for this
  42.  release will be in square brackets like this note].
  43.  
  44.  
  45. Copyright Status:
  46. ~~~~~~~~~~~~~~~~~
  47. The copyright as a Metro Door is held by me. This package may be 
  48. re-distributed electronically, provided a profit is not made by such
  49. distribution. If a profit is made, then the proceeds MUST be forwarded
  50. to me.
  51.  
  52.  
  53. Contact Me:
  54. ~~~~~~~~~~~
  55. Postal:
  56.  
  57. Peter Deane
  58. PO Box 228
  59. Swansea  NSW  2281
  60. AUSTRALIA
  61.  
  62. Call Inquestor BBS 24 Hours:
  63.  
  64. 011-61-49-72-1647 from the USA
  65. (049) 72-1647 from within Australia
  66.  
  67.  
  68. To set this up:
  69. ~~~~~~~~~~~~~~~
  70. In Doorfiles1 or Doorfiles2 or (...) create a blank directory called
  71. DoorX. (X=a spare number in accordance with the Metro Docs). Copy all
  72. the files from this archive into this directory, and then rename the
  73. file 'Door60' to 'DoorX'.
  74.  
  75. You will need to also have a copy of the file '8s.scores' in this directory.
  76.  
  77. Then add a command to BBSFILES/DoorCmdsY so the users can get to it.
  78.  
  79. Okay, if you DO have any probs, see the Metro Docs...
  80.  
  81. [Under OzMetro it's simply Door.exe in the DoorfilesX/DoorXXX directory,
  82. also the Menu to add the command to is MenuCmds_XX]
  83.  
  84.  
  85. Files:
  86. ~~~~~~
  87.  
  88.   8s.bas
  89.   8s.doc
  90.   8s.scores
  91.   8s.scores.blank    (This is a spare if you want to reset the scores)
  92.   door.exe
  93.   dos.bmap      <--- this isn't actually required, but it's here, anyway
  94.   graphics.bmap
  95.  
  96.  
  97. All you need for this to run is a copy of the Door and '8s.scores' in your
  98. door directory. That's it. No menus, or any other files are required - they
  99. are now internal to the program.
  100.  
  101.  
  102. The Game:
  103. ~~~~~~~~~
  104. For instructions as to how to play the game, run the door and use the
  105. <I>nstructions option.
  106.  
  107. As an interesting feature, the original program made use of the 
  108. narrator.device. So I left it in: for LOCAL logins only. Naturally, you
  109. need the translator.library and the narrator.device on your boot disk if
  110. you want to take advantage of this. (Hard drive users yawn...)! Don't
  111. forget to turn the sound up!
  112.  
  113. Changes in this version are many. First and foremost, there is local
  114. ANSI graphics. An 8 colour Hi-Res/non-interlace screen is opened (for 48k
  115. of chip ram), and the Sysop can see all the pretty stuff only remote
  116. callers have been getting with my doors before.
  117.  
  118. Because I can see what the output really looks like, I made a few changes
  119. to the choices of colour from the original. Also, some of the output
  120. has been tidied up, and it's been made SLIGHTLY more user friendly.
  121.  
  122. Again, credit must go to Craig Jackson, whose 'Wall Door' inspired the
  123. methods I use for getting local ANSI.
  124.  
  125. The game now has a Top Scores Table (actually, the LOWER the score, the
  126. better), so this will hopefully increase the popularity of this door.
  127. Players can now compare their results with others'. The way this works
  128. is best explained in the instructions within the door.
  129.  
  130. It is now also possible to Quit from a game without having to play it
  131. out to the end. Simply enter 'Z' as the card to play, and you'll be asked
  132. to confirm your request to quit the game.
  133.  
  134. If you should quit while halfway through a Competition game where the
  135. high scores are at stake, your current score will NOT be added to the
  136. High Scores Chart.
  137.  
  138. By the way, the window is opened up 2 pixels down from the top, so you can
  139. get to the push-to-back gadget without fumbling for ScreenX or a similar
  140. program, if you don't want the door at the front when working on your
  141. Amiga.
  142.  
  143. In release 1.0B, some screen clearing between turns and at the end is
  144. attempted. I originally had this in in the very first version I got
  145. running, but took it out. Well, it's back now, so I hope this works okay.
  146.  
  147. I also fixed up the time decrement bit so the after-midnight caller doesn't
  148. get 1570 minutes left at the witching hour! With the old system if a user
  149. was in the door at 11:59pm and had 5 minutes left, at 12:00, he'd have
  150. about 1600 minutes left! :-)
  151.  
  152. If you wish to tell the difference between 1.0A and 1.0B, have a look at
  153. the dates on the high scores. The format of the date is now like 01-Jan-91
  154. (Fido format).
  155.  
  156. Version 1.0c didn't do all that much. A couple of small changes when I
  157. noticed that the version number was wrong in the output. Changed two of
  158. the colours and eliminated 1 unnecessary line.
  159.  
  160. Version 2.0 has been specially recompiled to run under the OzMetro BBS
  161. system, and has a few VERY minor changes not worth mentioning.
  162.  
  163.  
  164. Menus:
  165. ~~~~~~
  166. The menus make use of the IBM font, and you, too can get it running
  167. on your Amiga globally, replacing the horrible old Topaz font that comes
  168. standard.
  169.  
  170. What I do is have two fonts directories containing the IBM font set up.
  171. The first one is called IBM and in it is the file '8' which is the font
  172. itself. I leave this one well alone for the other programs to use.
  173.  
  174. The other font directory is the same, but has a different name. Let's say
  175. it's called 'PCFont'. To get the Amiga to use this everywhere (including
  176. with Metro) you need to simply make use of the 'FF' command that comes
  177. on the workbench 1.3 (+) release.
  178.  
  179. In your startup-sequence, simply issue the command:
  180.  
  181.      FF PCfont.font
  182.  
  183. It should then say that the Topaz font has been replaced, and warn you
  184. that the font X or Y dimensions do not match. I don't know why it does
  185. this, but I have been using it since the first GFA Metro version came out,
  186. and have never had problems from any application at all. I am now looking
  187. at a nice smooth, round font in the editor. Heaps better than topaz ever
  188. was!
  189.  
  190. If you should ever need to access the Topaz font, it will be now accesible
  191. as PCfont. Basically, all FF does is to swap the two types around. (And 
  192. this is why you need two IBM font directories and fonts. Some programs DO
  193. ask for the IBM.font, and if you only had 1 copy, they'd then be using
  194. what they call ibm.font, but what the SYSTEM calls topaz!!)
  195.  
  196.  
  197. Known Bugs:
  198. ~~~~~~~~~~~
  199.  
  200. If a player plays an Ace, and the next player draws a card, the NEXT player
  201. will be skipped, too! I can't track down where in the original program this
  202. is handled, so it's still in. Not a major problem, actually! An interesting
  203. variation. (Yep, still in, in version 1.0. Fast to become a 'House Rule' I
  204. think. The original code is such spaghetti, I can't see where it is....).
  205.  
  206.  
  207. Source:
  208. ~~~~~~~
  209.  
  210. I have supplied the full source code to the door in AmigaBASIC. You are
  211. warned to never, under any circumstances, attempt to modify this code.
  212. Doing so will cause severe headaches, many sleepless nights, psychoses,
  213. severe personality defects, and strain. It may also cause damage to computer
  214. equipment - smashed monitor glass and malfunctioning keys being the most
  215. common occurences.
  216.  
  217. I disclaim all responsibility for any adverse affects received by attempting
  218. to modify this code.
  219.  
  220. In other words, it's a BIG MESS. I have never inflicted such unstructured
  221. rubbish upon anyone before, and will attempt to never do so again. This
  222. is mainly due to the fact that I did not actually write the playing sections
  223. of code, and simply modified an existing AmigaBASIC game.
  224.  
  225. It apparently started life as an 8-bit game, was modified to run under
  226. AmigaBASIC as a stand-alone game, was modified to give version 0.5 of the
  227. door a few months ago, and has now been modified yet again to give this
  228. version.
  229.  
  230. Accordingly, it's not going to get any better. However, rest assured there
  231. are no major bugs, it compiles without error, and runs beautifully on
  232. my system.
  233.  
  234. I am only including the source so you can see how NOT to write a door!!
  235.  
  236.  
  237. Conclusion:
  238. ~~~~~~~~~~~
  239.  
  240. In all, there's not much else I can say about the door in the docs. It's
  241. real easy to setup, looks great, and has a high scores chart. Get to it
  242. and make your mark on the high scores table while it's still easy!!
  243.  
  244.  
  245. [This is a TOP door, it really gets you in.  I have spent TOO MANY
  246.  hours playing this one, and too many now while recompiling it :-) ]
  247.  
  248.